AddProperty

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODStorageUnitView

AddProperty
The AddProperty method adds a property with the specified name to the storage unit that created this storage-unit view.
ODStorageUnitView AddProperty (
                           in ODPropertyName propertyName);
propertyName
The name of the property to be added.
return value
A reference to this storage-unit view.

DISCUSSION
If the storage unit that created this storage-unit view does not already contain a property with the specified name, the new property is added and the storage unit is focused on the newly added property. Otherwise, the storage unit is focused on the existing property with the specified name.
The focus context of this storage-unit view remains unchanged.

EXCEPTIONS

kODErrCannotAddProperty
Cannot add the specified property to the storage unit that created this storage-unit view.
kODErrIllegalNullPropertyInput
The specified property name is null.
If the storage-unit cursor for this storage-unit view does not represent a legal focus context for the storage unit that created this storage-unit view, this method throws exceptions raised by the FocusWithCursor method of that storage unit.

SEE ALSO
The ODPropertyName type (page 904).
The ODStorageUnitView::GetProperty method (page 741).
The ODStorageUnitView::Remove method (page 754).